package cn.iocoder.yudao.module.reading.service.user;

import cn.iocoder.yudao.framework.common.pojo.PageResult;
import cn.iocoder.yudao.module.reading.controller.app.user.vo.UserSoftDeletedPageReqVO;
import cn.iocoder.yudao.module.reading.controller.app.user.vo.UserSoftDeletedRespVO;
import cn.iocoder.yudao.module.reading.controller.app.user.vo.UserStatsOverviewRespVO;
import cn.iocoder.yudao.module.reading.dal.dataobject.user.UserDO;

import java.util.Collection;
import java.util.List;

/**
 * 用户 Service 接口
 *
 * @author 李晨
 */
public interface UserService {

    /**
     * 获取用户统计概览
     *
     * @param userId 用户ID
     * @return 用户统计概览
     */
    UserStatsOverviewRespVO getUserStatsOverview(Long userId);

    /**
     * 注销用户账号
     *
     * @param userId 用户ID
     */
    void logoutAccount(Long userId);

    /**
     * 删除用户账号（需要密码验证）- 软删除
     *
     * @param userId 用户ID
     * @param password 用户密码
     * @param reason 删除原因
     */
    void deleteAccount(Long userId, String password, String reason);

    /**
     * 永久删除用户账号（硬删除）- 管理员操作
     *
     * @param userId 用户ID
     * @param reason 删除原因
     */
    void permanentDeleteAccount(Long userId, String reason);

    /**
     * 分页查询已软删除的用户 - 管理员操作
     *
     * @param pageReqVO 分页查询条件
     * @return 已软删除用户分页结果
     */
    PageResult<UserSoftDeletedRespVO> getSoftDeletedUserPage(UserSoftDeletedPageReqVO pageReqVO);

    /**
     * 获取单个用户
     *
     * @param id 用户ID
     * @return 用户信息
     */
    UserDO getUser(Long id);

    /**
     * 获取用户列表
     *
     * @param ids 用户ID集合
     * @return 用户列表
     */
    List<UserDO> getUserList(Collection<Long> ids);

    /**
     * 恢复软删除的用户 - 管理员操作
     *
     * @param userId 用户ID
     * @param reason 恢复原因
     */
    void restoreSoftDeletedUser(Long userId, String reason);

}
